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INTRODUCTION 
The previous two volumes gave insight into the program structure, 


but not the detailed information necessary to delve into the code list- 


ings. The previous information should be satisfactory for the user who 


is willing to accept the program output as reasonable and is only interested 
in running his case; but the analyst or programmer who needs to assess 

the applicability of a model to his purposes, or wishes to modify the 

code, requires additional structural details. The intent of this volume 


is to provide these details. 


This volume is divided into two sections. The first provides 
detailed information about the dataset structure used in the systems and 
physics interface modules. The second contains detailed information 
about the length and calling structure of labeled common blocks, sub- 


routines, and functions. 


SECTION 1: DATASET NOTEBOOK 
The dataset notebook is made up of the following parts: 


1.1 Data Descriptor Deck 

Ped Complete Data Listings 
1.3 Dataset List by Name 

1.4 Dataset List by Mnemonic 
1.5 Variable Name List 

1.6 Dataset Calls 


Section 1.1 consists of card images of a data descriptor deck which 
is the primary source for the parts which follow. The first card in each 
dataset contains the word NEW in columns 1-3; a two-character mnemonic 
in columns 5-10, which identifies the dataset and which is appended as a 
suffix to the names of all the variables in that dataset; and the data~ 
set name starting in column 15. Succeeding cards describe the individual 


variables in the dataset. These cards are punched as follows: 


Fortran variable type (where H = Hollerith, I = integer, 
R = real, Ri = vector of length i, Ai = array of length 
i, DSP = pointer to another dataset, LHV = list header 


variable, P = continuation card for variable definition) 


Column 5: Variable name (five characters or less to which the 


two-character dataset mnemonic will be added) 


Column 15: Variable description 


The data descriptor deck is passed through a processing program 
(PRINOUT) to produce the next four parts of the dataset notebook. This 
program also produces punched-card equivalence blocks for each dataset 
suitable for automatic inclusion in the compiled programs which require 


them. 


Section 1.2 is a segment of the output from the PRINOUT program. 
This part prints the contents of the datasets and their composite mnemonics 
in an easy-to-read form. The two-letter dataset mnemonic, the dataset 
name, and a number are given on the first line. This is followed by 
descriptions of each word in the dataset including the word number, the 
Fortran variable type (integer, real, Hollerith, DSP, or LHV), and a 
short phrase describing the variable. In addition, the total number of 
words in the dataset is provided. (Note that the number of words exceeds 


the number of variables when any of them are vectors or arrays.) 


The next two outputs from PRINOUT (Secs. 1.3 and 1.4) are lists of 
the datasets, alphabetized by name and by the two-character mnemonic, 
respectively. In each case, the dataset number is given so that the 


desired dataset information can be quickly found in Sec. 1.2. 


The last output from PRINOUT (Sec. 1.5) is an alphabetical list of 
all variables in the dataset notebook, with the mnemonics and numbers of 
the datasets in which they reside. Thus to find the definition of a par- 
ticular variable, the user can look it up in this part of the notebook, 


get the dataset number, and look up the variable definition in Sec. 1.2. 


Finally, Sec. 1.6 contains dataset calling structure information. 
Here, each dataset (and common block) is given on the left, followed by 
a list of all subroutines which use it on the right. This listing can be 
useful to the programmer when a dataset is revised, so that all subrou- 


tines which call it can be recompiled and make use of the new data. 


SECTION 2: PROGRAM STRUCTURE NOTEBOOK 
A second notebook showing some elements of the program structure is 


given in Sec. 2, which includes the following parts: 


20% Subroutine Length/Externals 
2.2 List of Routines Calling a Specific Subroutine 
2.3 List of Routines Containing a Specific Common 


2.4 List of Routines Called by a Specific Subroutine 


Section 2.1 is a list of all ROSCOE subroutines, programs, and func- 
tions. The basic ROSCOE routines are given in alphabetical order, fol-~ 
lowed by the FLEXRED, DSA, and TRAID routines ordered as they currently 
exist on these files. The routines are numbered and the date they were 

‘ last compiled is given. This list shows the program length, the exter~ 
nals called directly by this routine (including library subroutines and 


functions), the common blocks used, and all entry points to the routine. 


Section 2.2 again lists each subroutine alphabetically, this time 
with a list of all subroutines which call the given routine. A similar 
output for common blocks is given in Sec, 2.3. The form of this table 
is as follows: common block number, common block name (listed alpha- 
betically), common block length, list. of subroutines which contain this 
common. Note that the blank common storage area can be dimensioned dif- 


ferently in each routine. 


Section 2.4 contains the complement of the information given in 
Sec. 2.2. That is, for each subroutine, a list is given of all the sub- 
routines it calls (directly or in a secondary fashion). In addition, the 


total length of all subroutines called is given. 


This list is particularly useful for determining overlay structure, 
since all the routines in a given overlay must be contained in the main 
program listing for that overlay. For example, the prompt energy deposi- 
tion in the high-altitude grid is computed by program PROMPG. Section 
2.4 shows that PROMPG and the routines it calls (and the routines they 


call, etc.) require 11033 words of storage, not including common storage 


and higher-level overlay storage. 
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